home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / okf220.zip / OKDOCS.ZIP / OK.DOC next >
Text File  |  1990-10-30  |  81KB  |  2,034 lines

  1.                       OPTIKS
  2.  
  3.           Graphics Editor by Keith P. Graham
  4.  
  5. Thank you for choosing OPTIKS. OPTIKS is a system for changing PC
  6. graphics files. OPTIKS can read and write many different graphic
  7. file types. OPTIKS is useful for converting files from one type to
  8. another, sizing files and changing files in many ways. OPTIKS is
  9. easy to use and easy to learn. It is a very complicated program in
  10. some ways, but it has very easy paths to let you do exactly what
  11. you need to do with a minimum of fuss. 
  12.  
  13. Now that you have OPTIKS, what do you do next? 
  14.  
  15. First you will have to install OPTIKS (this takes about 2 minutes).
  16. You should practice for another few minutes, loading and saving a
  17. file, and then you should browse through the manual. The manual is
  18. nice to have, but it spends most of the time on the shelf. You will
  19. only have to use the manual if you are having a problem or trying
  20. to do something a little complicated. The manual has installation
  21. instructions, a few overview chapters, many examples of common
  22. things that you might want to try, and a series of discussions of
  23. all of the OPTIKS options. Start by installing OPTIKS and then try
  24. a few of the examples. You will be an expert in a few minutes and
  25. with good luck, never have to use the manual again. 
  26.  
  27.  
  28. TABLE OF CONTENTS 
  29.  
  30. 1. Installing OPTIKS 
  31. 2. Starting Up OPTIKS 
  32. 3. What is OPTIKS? 
  33. 4. How to Use the Menu Tree 
  34. 5. Selecting Files 
  35. 6. Viewing a Picture 
  36. 7. Help System 
  37. 8. Mouse and Keystrokes 
  38. 9. Keyboard Macros 
  39. 10. Altering an Image 
  40. 11. How to Save an Image 
  41. 12. Configuration options 
  42.     a. Screen Type
  43.     b. Virtual Screen Width
  44.     c. EMS Memory
  45.     d. Miscellaneous Options
  46.     e. Printer Options
  47.     f. Saving the CONFIG.OK file
  48.     g. Debug Break Points
  49. 13. Drawing 
  50. 14. Scanning 
  51. 15. Mandelbrots 
  52.   
  53. Appendix: 
  54.  
  55. A. Problems       
  56. B. Menu Tree      
  57. C. Example of converting a file
  58. D. Using Color 
  59. E. Using HP Soft Fonts 
  60. F. Supported File Formats 
  61. G. Canon Scanner Driver and Switches
  62.  
  63.  
  64.  
  65. CHAPTER 1. Installing OPTIKS 
  66.  
  67. OPTIKS needs no special setup for most situations. The program will
  68. try to figure out what video screen you have and if you have a
  69. mouse and EMS memory. If you start up OPTIKS and get a blank
  70. screen, please refer to APPENDIX A. Installing OPTIKS only requires
  71. that you copy the OPTIKS programs to a disk where you can get at
  72. them. 
  73.  
  74. Floppy disk installation 
  75. Copy OKPRIV.EXE (or OKFREE.EXE if you are testing out the free 
  76. version) to a floppy. Copy any OPTIKS screen fonts that you will
  77. be using to the floppy. For example: Put the OPTIKS disk in drive
  78. A: Put a blank formatted disk in drive B: At the dos prompt enter:
  79. COPY A:*.* B: This will copy all of the OPTIKS files (even some
  80. that you probably don't need) to the B: drive. Label the disk in
  81. B: OPTIKS and put the original disk with you other important disks
  82. in the back of the bottom shelf of the refrigerator (or some other
  83. cool safe place). Now to start OPTIKS from the floppy, from the A
  84. prompt enter: OKPRIV and press return. (enter OKFREE if you are
  85. testing the free version). Don't write protect the diskette. OPTIKS
  86. may want to create a file called config.ok, and you may want to use
  87. the diskette for storage of some graphics files. 
  88.  
  89. If you are not installing on a hard disk, skip over to the
  90. discussion of STARTING OPTIKS.  
  91. Installing OPTIKS on a Hard Disk. 
  92.  
  93. On a hard disk, all packages (including DOS) should have their own
  94. sub directory to live in. The root directory should have the
  95. following files: COMMAND.COM, CONFIG.SYS and AUTOEXEC.BAT. The root
  96. directory should have only these three files and the list of
  97. subdirectories. If you have anything else on you root directory you
  98. are slowing down the operation of you hard disk. All programs
  99. should be located in separate directories for each subsystem.
  100. OPTIKS should have its own subdirectory. To create an OPTIKS
  101. subdirectory, you will have to be at a DOS prompt. The following
  102. assumes that you are installing OPTIKS on your C: disk and you want
  103. a subdirectory called OK. 
  104.  
  105. Make sure that you are at the DOS C> prompt. If you have an A> or
  106. a B> enter "C:" and change to the C: disk. Next change up to the
  107. ROOT directory. This is the disks main directory, where all other
  108. directories start from. Enter: CD \ Press return. The slash used
  109. here is the "back slash". It tilts backwards. You should be at the
  110. root. 
  111.  
  112. Some people have a prompt command in their AUTOEXEC.BAT (the
  113. command is PROMPT $P$G) that will show them which directory they
  114. are in. If you are not sure which directory you are in just type
  115. "CD" and press return, this will show you the current directory.
  116.  
  117. Next create the OK directory by entering: MD OK and press return.
  118. The "MD" command stands for Make Directory. It will make a
  119. directory called OK. If you enter DIR after you finish making the
  120. directory, you will be able to see the OK subdirectory listed. If
  121. you get an "Unable to Create Directory" error it means that there
  122. already is an OK directory. The next step is to copy the files from
  123. the OPTIKS disk to the directory. Place the OPTIKS main diskette
  124. in drive A: and enter the following: 
  125.  
  126.  COPY A:*.* OK 
  127.  
  128. There is no space between the : and the *.*. There are spaces
  129. between the COPY command and the A and before the OK. You don't
  130. have to use upper case letters with DOS. Press the return. This
  131. will copy all of the programs and information from the A: disk into
  132. the OK subdirectory. 
  133.  
  134. When the copy is done, you can take the diskette in A: out and put
  135. it in a cool safe place. OPTIKS may come with some diskettes of
  136. sample graphics. You can copy this into the OK subdirectory, but
  137. some people like to keep pictures in a separate PIC subdirectory.
  138. You can use the same procedures above or refer to your DOS manual
  139. to copy the pictures into a subdirectory. 
  140.  
  141. Renaming the OPTIKS program. 
  142.  
  143. The name OKPRIV is not that easy to type. After you install OPTIKS
  144. it might be a good idea to rename the OKPRIV.EXE program to OK.EXE.
  145. This makes it easy to remember how to start the program. If you
  146. rename the program, make a note to yourself that you enter OK and
  147. press return to start up OPTIKS. 
  148.  
  149.  
  150.  
  151. CHAPTER 2. Starting Up OPTIKS 
  152.  
  153. Change to the OPTIKS directory by entering: CD\OK and pressing
  154. return. The main OPTIKS program is called OKPRIV.EXE (I always
  155. rename this file to OK.EXE to make it short.) If you are using
  156. floppies, you can start up OPTIKS by typing OKPRIV and pressing
  157. return. OPTIKS will start up right away and show you the OPTIKS
  158. logo and a menu. If you spelled the OPTIKS program name correctly
  159. and pressed return and got the message "Bad command or file name"
  160. then something is wrong. The easiest thing to do if you get this
  161. error is to enter DIR and see what you get. This will help you
  162. figure what is going on. For the OKPRIV command to work, OKPRIV.EXE
  163. must be on the current disk and current directory OR there must be
  164. a PATH set so that DOS can find the OKPRIV.EXE file. If you want
  165. to start OKPRIV then you either have to be on the C: disk in the
  166. OK directory or you have to set the path so that OKPRIV can be
  167. found. 
  168.  
  169. The OPTIKS configuration file 
  170.  
  171. In OPTIKS it is possible to save your configuration. Your
  172. configuration includes things like your choice of printer and how
  173. much EMS memory you want to use. This is done by "KEEPING" your
  174. configuration. When you save a configuration the configuration us
  175. kept in a file called CONFIG.OK. OPTIKS looks for CONFIG.OK when
  176. it starts up. If it can't find the file, it uses defaults.
  177. CONFIG.OK must be in the current directory when you start up or
  178. OPTIKS won't find it. CONFIG.OK is small so you may want to keep
  179. copies around wherever you start up OPTIKS. 
  180.  
  181.  
  182.  
  183. CHAPTER 3. What is OPTIKS? 
  184.  
  185. OPTIKS is a large area into which pictures can be brought. You
  186. bring in the picture by using the FILE READ or FILE MERGE options
  187. from the menu. The FILE READ option cleans out the work space where
  188. the FILE MERGE option will set the picture into a frame that you
  189. specify. 
  190.  
  191. Once the picture is in the work space you can copy it or alter it
  192. in various ways. You can save the picture by using the FILE SAVE
  193. option. You must tell OPTIKS how much of the picture to save. You
  194. don't want to save the entire work space. You would quickly fill
  195. up the disk with pictures surrounded by a lot of empty black space.
  196. The OPTIKS work space is a lot wider than your screen. You can move
  197. around in it. In this way you can have pictures which are bigger
  198. than one screen. The width of the work space is called the VIRTUAL
  199. WIDTH. The length of the work space is called the VIRTUAL LENGTH.
  200. Think of the screen in front of you as a window to look into the
  201. OPTIKS work space. The work-space holds the image data and the
  202. Video Screen is a window to look at the image data in the work
  203. space. Pressing the HOME key brings you to the upper left corner
  204. and pressing the END key brings you to the lower right corner. The
  205. area defined by Virtual Width and Virtual Length (it might be
  206. called Virtual Area) is limited by how much memory you have. 
  207.  
  208. Memory is allocated when you start up OPTIKS right up to the
  209. maximum in you machine. If you have EMS memory OPTIKS will take a
  210. good chunk of that. The default width of the screen is 1024 pixels
  211. wide. This is wider than most screens, but it is narrower than some
  212. pictures. A common problem is that pictures seem to be cut off on
  213. the right after loading. This is because the Virtual width is too
  214. small to handle the width of the picture. Change the Virtual width
  215. using the /ENVIR CONFIG VIRT menu options. Remember that by making
  216. the work-space wider you reduce the Virtual Length. This is because
  217. you have limited memory. If the image starts cutting off on the
  218. bottom you will have to reduce the Virtual Length or get more
  219. memory. 
  220.  
  221.  
  222.  
  223. CHAPTER 4. How to Use the Menu Tree 
  224.  
  225. The main way of making OPTIKS work is through the Menu Tree. Check
  226. out the WHATS.NEW file on the OPTIKS distribution diskette to find
  227. out about latest additions and changes to OPTIKS. The Menu comes
  228. up all by itself when you start OPTIKS. You can press the / key to
  229. get it back after you have viewed a file. You can also press the
  230. Esc key. The / and the Esc work a little different. The / always
  231. brings you to the main menu. The Esc Keys brings you back to the
  232. last menu you were working from before you entered VIEW mode.  The
  233. menu consists of a line of options with a line of explanation below
  234. the options. One option is shown in reverse video. The explanation
  235. line is for the menu item that has the reverse video. If you use
  236. the cursor control keys you can move the reverse video to another
  237. menu item. The left and right arrows move the reverse video back
  238. and forth. The explanation line changes for each menu item. To
  239. select a menu item, move the reverse video to that item and press
  240. the Enter Key. This will either bring you to a new menu or to one
  241. of the OPTIKS functions. 
  242.  
  243. You will notice that each menu item begins with a different letter.
  244. If you press the first letter of any menu item it is the same as
  245. moving to that item and pressing enter. For example to read an
  246. Apple Mac picture you would could: 
  247.  
  248. 1) Press the / key to bring up the main menu. 
  249.  
  250. 2) Move to the FILE menu item. 
  251.  
  252. 3) Press the enter key. 
  253.  
  254. 4) Move to the READ menu item. 
  255.  
  256. 5) Press the enter key. 
  257.  
  258. 6) Move the cursor to MAC. 
  259. 7) Press enter. 8) You will see a file selection list at this
  260. point, move to the file you want and press enter. 
  261.  
  262.  ----OR---- 
  263.  
  264. Press /FRM enter and select the file. 
  265.  
  266.  
  267.  
  268. CHAPTER 5. Selecting a file. 
  269.  
  270. There are hundreds of graphics packages and most packages have
  271. unique file types. Originally the idea was to restrict a user to
  272. using only one graphics package, but experience shows that the more
  273. adaptable and flexible a package, the more it will be used. OPTIKS
  274. increases the usefulness of these packages by allowing transfers
  275. of data between them. In order to read or write a file, you must
  276. know 1) the kind of file, and 2) the file name. 
  277.  
  278. Whenever you choose READ, WRITE, MERGE or INFO from the FILE menu
  279. you are presented with a list of file types. OPTIKS can read and
  280. write a large number of formats. 
  281.  
  282. Sometimes OPTIKS can read a file, but can't write the same format.
  283. In some cases, OPTIKS can write a format, but can't read it. The
  284. file formats are listed in alphabetical order. File types which the
  285. DEMO version of OPTIKS can write are marked with an asterisk (*).
  286. You can use the cursor control keys to move around the list of file
  287. types. As you move, the file types are highlighted and a
  288. description of the file type is shown to you. You can press the
  289. first letter of the file type and you will jump immediately to the
  290. first match. Press the letter again and you will jump to the next
  291. match. When you have highlighted the file type that you want, press
  292. the enter key and you will go to the next step. 
  293.  
  294. OPTIKS goes to the disk and finds all of the files that have the
  295. corresponding extension and shows you all of the files available.
  296. If you see the message "No Matching Files" then the file selection
  297. criteria did not find any files. This message appears for a moment
  298. while OPTIKS searches your disk, but it should go away if any files
  299. are found. 
  300.  
  301.  
  302.  
  303. Selecting an existing file. 
  304.  
  305.  
  306.                ╔══════════════════════════════════════╗
  307.                ║           READ A FILE                ║
  308.                ║ Select a File Format and Press Enter ║
  309.                ║        Press Esc to Exit             ║
  310.                ╚══════════════════════════════════════╝
  311.     AutoCAD ACAD Slide
  312.       ╔════════════════════════════════════════════════════════╗
  313.       ║ ACAD SLD      EFS           PCR        * WIPS          ║
  314.       ║ ASCII         FAX           PCR FONT 1   WPG           ║
  315.       ║ AMIGA IFF     GEM           PCR FONT 2   ZSOFT PCX     ║
  316.       ║ ART           GIF           PCR FONT 3                 ║
  317.       ║ BASIC      *  HALO CUT      PCR FONT 4                 ║
  318.       ║ BLOAD CGA  *  HP PRINTER    PDA                        ║
  319.       ║ BLOAD EGA  *  HP SOFT FONT  PIG                        ║
  320.       ║ BLOAD AT&T *  IBM ISF       PMG                        ║
  321.       ║ BLOAD HERC *  LOTUS PIC     POSTSCRIPT                 ║
  322.       ║ BLOAD VGA  *  MAC           PRINT POWER                ║
  323.       ║ BLOAD EEGA *  MOUSE         PRINTSHOP                  ║
  324.       ║ BLOAD 720  *  MSP           RAS                        ║
  325.       ║ DCX           NEWSMASTER    RLE                        ║
  326.       ║ DEGAS         NEWSROOM PRO  TIFF                       ║
  327.       ╚════════════════════════════════════════════════════════╝
  328.  
  329. Fig. 1 Read File List Menu.
  330.  
  331.  
  332.  
  333.  
  334. When you read a file or ask for information about a file, you must
  335. be talking about a file that already exists. If you are writing a
  336. file to disk you may be overwriting an existing file or naming a
  337. new file. To select an existing file, you can move the reverse
  338. video bar up and down and select the file you want. If there are
  339. more files than can appear on the screen at once you can use the
  340. PgUp and PgDn to move through the pages of files until you find the
  341. one you are looking for. 
  342.  
  343. The file that you are looking for may not be found on the current
  344. disk or subdirectory. You may have to change the way OPTIKS looks
  345. for a file. You can press the / key or F10 to move the cursor up
  346. to the selection line. Correct the selection line to correctly
  347. match the disk, path and filename of the file you want. 
  348.  
  349. For instance, when you want to read a MAC file OPTIKS expects the
  350. file name to end in the extension .MAC and lists *.MAC files. The
  351. *.MAC means list all files ending in .MAC. You may have the file
  352. on your disk as GRAPH.PIC. Even though it is a MAC file, you have
  353. it named as .PIC. (This is quite common. There is no standard
  354. naming convention for Apple Mac files.) You would have to press the
  355. / key from the file selection screen and change the *.MAC to *.PIC
  356. or even GRAPH.PIC and then press enter. You will be shown all of
  357. the matches. You can change the current working disk and
  358. subdirectory by retyping the information on the selection criteria
  359. line. OPTIKS remembers when you change the disk or directory and
  360. will use the new value every time you make a new selection. 
  361.  
  362.  
  363.  
  364.  
  365. Writing to a new file. 
  366.  
  367.  
  368.                ╔══════════════════════════════════════╗
  369.                ║           SAVE A FILE                ║
  370.                ║ Select a File Format and Press Enter ║
  371.                ║        Press Esc to Exit             ║
  372.                ╚══════════════════════════════════════╝
  373.     AutoCAD Binary Drawing Interchange Format
  374.       ╔════════════════════════════════════════════════════════╗
  375.       ║ ACAD DXB      GEM           TIFF PACK                  ║
  376.       ║ ACAD DXF      GEMDRAW       WIPS                       ║
  377.       ║ ACAD SLD      HALO CUT      WPG                        ║
  378.       ║ ART           HP LETTER     ZSOFT PCX                  ║
  379.       ║ BASIC      *  MAC HEAD                                 ║
  380.       ║ BLOAD CGA  *  MAC NOHEAD                               ║
  381.       ║ BLOAD EGA  *  MOUSE                                    ║
  382.       ║ BLOAD AT&T *  MSP                                      ║
  383.       ║ BLOAD HERC *  PCR        *                             ║
  384.       ║ BLOAD VGA  *  PIG                                      ║
  385.       ║ BLOAD EEGA *  POSTSCRIPT                               ║
  386.       ║ BLOAD 720  *  RAS                                      ║
  387.       ║ COM           SYS                                      ║
  388.       ║ EFS           TIFF UNCOMP                              ║
  389.       ╚════════════════════════════════════════════════════════╝
  390.  
  391.  
  392. Figure 2. Save File List Menu.
  393.  
  394.  
  395.  
  396. When you save to a new file or print to disk, you are given the
  397. same selection screen that appears when you want to read a file.
  398. You don't usually want to select an existing file. If you did you
  399. would point to it and press enter, but this won't work when
  400. creating a new file. To write to a completely new file, press F9
  401. key to get to the file selection criteria line and enter the name
  402. of the file that you want to create. If OPTIKS can't find the file
  403. it will create it. You can change the disk and directory at the
  404. same time and OPTIKS will create the file on another disk or
  405. directory. 
  406.  
  407.  
  408.  
  409. CHAPTER 6. Viewing a Picture 
  410.  
  411. After loading a picture, OPTIKS goes into VIEW MODE. VIEW MODE is
  412. when the MENU is not on the screen. The keys act differently in
  413. VIEW MODE. For instance, the right arrow does not, highlight a menu
  414. item, it moves the picture to the left. Whats really happening is
  415. the video screen window moves to the right. You can move your view
  416. of the image by using the keys to move the window to a different
  417. part of the image. The cursor control keys move you around the
  418. picture. End brings you to the lower right corner, Home brings you
  419. to the upper left corner. PgUp and PgDn move the window faster the
  420. than up and down arrows. You can use the CTRL key with the arrow
  421. keys to move faster. 
  422.  
  423. When you are in VIEW mode you can return to the menu by pressing
  424. the / key. There are several "fast path" keys also available to
  425. you, you can refer to chapter 8 for keystrokes. 
  426.  
  427.  
  428.  
  429. CHAPTER 7. Help System 
  430.  
  431. The F1 key is always HELP. But since memory is so important I have
  432. purposely left the help screens small. There are five help pages.
  433. The help pages are: Cursor - for keys which control cursor
  434. movement. Range - for keys which control the range. Menu - a quick
  435. guide to using the menu. File - a little bit of information about
  436. entering file names. Keys - most of the OPTIKS keystrokes and fast
  437. paths. 
  438.  
  439.  
  440.  
  441. CHAPTER 8. OPTIKS Mouse and Keystrokes 
  442.  
  443. OPTIKS was designed to be used quickly and efficiently from the
  444. keyboard. This allows single keystrokes to have a great deal of
  445. functionality. There are many keystrokes available to you,
  446. depending on where you are and what you are doing. 
  447.  
  448. Mouse "keys" 
  449.  
  450. A Microsoft compatible mouse will give you the ability to move
  451. around in OPTIKS without using the keypad. The mouse acts like the
  452. cursor control keys, Moving the mouse left is equivalent to
  453. pressing the left arrow, moving the mouse to the right is
  454. equivalent pressing the right arrow. Moving the mouse up and down
  455. is like the up and down arrows, moving the mouse fast is like
  456. holding down a cursor control key or pressing page up or page down.
  457. The left button on the mouse is the Enter Key. The right button is
  458. the Esc Key. If you have a three button mouse the middle button is
  459. the / key. 
  460.  
  461. Keys that are always available. 
  462.  
  463. No matter what is on the screen, there are a few keys that are
  464. always available. These keys can be pressed at any time without
  465. interfering with the current screen. 
  466.  
  467. F1 - Help. This is the on- line help facility. To have full help
  468. the HELP.OK file must be in the OPTIKS start-up directory. Read
  469. chapter 6 on how to call up help and use it. 
  470.  
  471. ALT-G - this is the key to place a 16 by 16 pixel grid on the
  472. screen. This is useful for positioning objects. Press Alt-G once
  473. and the grid goes on. Press it again and it goes off. The grid
  474. disappears whenever the screen is cleared. 
  475.  
  476. ALT-N - Puts the name of the last file read on the bottom of the
  477. screen. 
  478.  
  479. Alt F1- F10 - Keyboard Macros. Macros are simply a list of
  480. keystrokes which can be started by pressing the ALT and one of the
  481. function keys. See chapter 9 for help on keyboard macros. 
  482.  
  483.  
  484.  
  485. Ctrl-Break - Pressing the Ctrl Key and break (scroll-lock) at the
  486. same time causes the main menu to appear. This upsets DOS and in
  487. DOS 3.3 and 4.0 it is possible to get a "stack overflow" message
  488. from DOS which will blow you out of the water. If you get this
  489. message you MUST reboot in order to clear DOS and start any
  490. programs. I consider this a DOS bug in 3.3 and 4.0. In any event,
  491. avoid pressing Ctrl- Break unless you are in real trouble. Try the
  492. F9, F10, / and Esc keys first. These keys generally give you better
  493. results than Ctrl-Break. 
  494.  
  495. MENU Keystrokes. 
  496.  
  497. When the menu is on the screen, you are in MENU MODE. Menu mode is
  498. where you make selections for performing various tasks. When you
  499. are in menu mode you can 
  500.  
  501. 1) select a new menu item, 
  502.  
  503. 2) select a task, 
  504.  
  505. 3) leave the menu, 
  506.  
  507. 4) ask for help. 
  508.  
  509. Moving around the menu was described in chapter 4. If you have not
  510. read chapter 4 and you don't understand how to move around in a
  511. menu you should turn to chapter 4 and learn how to move around the
  512. menu tree. The left and right arrows, the Enter key and the Esc key
  513. were described in chapter 4 for moving around in the menu. There
  514. are additional live keys which can be used for other functions. The
  515. following keys are "alive" while in menu mode. 
  516.  
  517. F10 - Leave the menu. 
  518.  
  519. F10 will knock you out of the menu and into VIEW MODE. VIEW MODE
  520. is where you can scroll around inside the virtual work-space and
  521. look at the picture. 
  522.  
  523. ESC - Moves up one level in the menu tree. If you keep moving up
  524. a level, you will eventually move completely back to VIEW MODE. 
  525.  
  526. When the Hour Glass is on the screen it means "please wait". It
  527. appears when OPTIKS is reading and writing a file or working on a
  528. portion of the screen. You can clear the screen and display the
  529. work in progress by pressing Alt-C. This is especially useful for
  530. Mandelbrots which can take hours to days to finish. The screen does
  531. not clear immediately, but will clear when finished with the
  532. current line. The work so far will be shown. Pressing the escape
  533. while the hour glass is on the screen will abort the current
  534. process.  
  535.  
  536.  
  537.  
  538. Chapter 9. The OPTIKS Command Line and Keyboard Macros 
  539.  
  540. The command OK (or OKPRIV if you have a private version) will start
  541. up OPTIKS. This is the normal way to enter into OPTIKS. Once in
  542. OPTIKS you would use the keyboard or the mouse to manipulate
  543. graphics. There are times when it may be convenient for OPTIKS to
  544. do some action from a BAT file or from the command line. You can
  545. do this by entering: OKPRIV keystrokes The keystrokes are the slash
  546. key: "/" and any valid sequence of OPTIKS menu items. Menu items,
  547. if you recall, can be entered by typing the first letter of each
  548. item. There are a few special keys also. They are: 
  549.  
  550. ~ (tilde) = Return key 
  551.  
  552. ^ (hat) = Escape Key 
  553.  
  554. @ = Home 
  555.  
  556. ! = End 
  557.  
  558. ? = Wait forever for a keystroke 
  559.  
  560. If the escape is pressed, the key sequence ends.  
  561.  
  562. $ = wait 2 seconds 
  563.  
  564. If the escape is pressed, the key sequence ends. 
  565.  
  566. * = restart the command line. 
  567.  
  568. This is for slide shows. 
  569.  
  570. + = up arrow 
  571.  
  572. - = down arrow 
  573.  
  574. ( = left arrow 
  575.  
  576. ) = right arrow 
  577.  
  578. ;x= start macro number x, x = 0 to 9 
  579.   
  580.  
  581.  
  582. An Example: 
  583.  
  584. OK frm~/!c:\ok\reflect~~$$$/qy 
  585.  
  586. Does the following: 
  587.  
  588. f=FILE  
  589.  
  590. r=READ 
  591.  
  592. m=MAC 
  593.  
  594. ~=Enter 
  595.  
  596. /=jump up to 
  597.  
  598. filespec area 
  599.  
  600. !=END (clears any found names from the line) 
  601.  
  602. reflect=name of mac file "C:\OK\REFLECT.MAC" 
  603.  
  604. ~=return 
  605.  
  606. - do it twice 
  607.  
  608. $$$$$=wait 10 seconds 
  609.  
  610. /=menu 
  611.  
  612. q=QUIT 
  613.  
  614. y=YES 
  615.  
  616.  
  617.  
  618. USING MACROS: 
  619.  
  620. If you find yourself doing the same thing over and over again you
  621. can put the keystrokes into a Macro. Use /CM to enter macros 1 to
  622. 10. Once the macro is entered you can use ALT-1 to ALT-0 to start
  623. the macro up. The special keys used on the command line (see OPTIKS
  624. COMMAND LINE) are the same symbols used for macros. The command
  625. line is a special case of macros. A macro is a series of keystrokes
  626. that will be entered from the macro just as though you entered them
  627. from the keyboard. If you save you config.ok file by entering /ECK
  628. you will also save any macros you have entered. You can have a
  629. macro start up automatically by entering something like: OKPRIV ;1
  630. The semicolon means jump to a macro, in this case macro 1. Macro
  631. 1 can end in ;2 which would make it jump to macro 2. Here is an
  632. example to load print a potion of a file: 
  633.  
  634. /ppr@~------------)))))))))))~g;2 
  635.  
  636. This is / to start off, P for print, P for printer, @ for home, ~
  637. for return, - for down, ) for right, another ~ for return and g to
  638. go. The ;2 means jump to another macro, in this case 2. If the 2
  639. macro printed out another portion of the screen, you could be
  640. chaining together macros to print a large picture. In total, macros
  641. can add up to 700 pre-recorded keystrokes. Pressing the Esc key
  642. will always kill a running macro. 
  643.  
  644.  
  645.  
  646. CHAPTER 10. Altering an Image 
  647.  
  648. Once an image has been loaded into memory you may alter the image
  649. in various ways. The IMAGE menu selection allows for moving parts
  650. of images, sizing parts of images and rotating images. You may
  651. enter the IMAGE menu from the Main menu or by pressing the "I" key
  652. when viewing an image. 
  653.  
  654. The image menu is a list of all of the IMAGE operations that may
  655. be performed on the picture. You may move through the various
  656. options, and as you do a description will appear giving a simple
  657. explanation of what the function can do. 
  658.  
  659.  
  660.  
  661.  
  662.  
  663.               ╔══════════════════════════════════════╗
  664.               ║         IMAGE ALTERATION             ║
  665.               ║   Make a Selection and Press Enter   ║
  666.               ║        Press Esc to Exit             ║
  667.               ╚══════════════════════════════════════╝
  668.     Fill a box with Current Pattern
  669.       ╔══════════════════════════════════════════════════════╗
  670.       ║ BFILL         ERODE         MIRROR        SIZE       ║
  671.       ║ BLANK         FADE          NEGATE        SMOOTH     ║
  672.       ║ BLUR          FAT BITS      OVERLAY       TALLER     ║
  673.       ║ CLIP          FLIP          RTILT 1       THIN       ║
  674.       ║ COPY          INLAY         RTILT 2       TURN       ║
  675.       ║ CONTRAST      LINE XOR      RTILT 1/2     UNSTEP     ║
  676.       ║ DEPOS         LTILT 1       SHADE         WASH       ║
  677.       ║ DOUBLE        LTITL 2       SHORTEN       WHITE OUT  ║
  678.       ║ EDGE          LTILT 1/2     SHRINK        WIDEN      ║
  679.       ╚══════════════════════════════════════════════════════╝
  680.  
  681.  
  682.  
  683. Figure 3. Image Menu. 
  684.  
  685.  
  686.    
  687. OPTIKS is non-destructive in that it does not erase a portion of
  688. the picture unless something is actually put on top. For example,
  689. if you decide to halve a section of the screen, you will see the
  690. new smaller picture on top of the original picture. Just because
  691. you shrank a portion of the screen it does not mean that OPTIKS
  692. erased the old image. The old image will remain with the new image
  693. on top of it.
  694.  
  695. ROTATE rotates an image 90 degrees clockwise. The ROTATE option
  696. always rotates a square. Your screen may have an odd aspect ratio
  697. (CGA is 3.2 to 1) so that you may not see a square on the screen.
  698. The area to be rotated is determined by the horizontal length of
  699. the range. ROTATE ignores any vertical range that you may have
  700. indicated.
  701.  
  702. COPY takes a section of an image and copies to another section of
  703. the work space. 
  704.  
  705. The steps for copying a range are: 
  706.  
  707. 1) Select COPY from the IMAGE menu. 
  708.  
  709. 2) Move the finger to the upper left hand portion of the area to
  710. be copied. Press Enter. 
  711.  
  712. 3) Move the finger to the lower right hand corner of the range and
  713. press enter. 
  714.  
  715. 4) When you move the finger now, the whole box will move. Move the
  716. range to where the range is to be copied and press return. 
  717.  
  718. 5) You may use this function to STAMP a picture over and over
  719. again. Press Esc when you are done copying. 
  720.  
  721. The HALVE option makes a picture half size. This is like SCALE, but
  722. it is faster and a fixed 1/2 size.
  723.  
  724. SHORTEN squashes down a picture by taking out every other line. 
  725.  
  726. NARROW takes out every other dot in the horizontal direction making
  727. the picture 1/2 of its original size.
  728.  
  729. DOUBLE makes a picture twice its size.
  730.  
  731. WIDER doubles every dot making the picture twice as wide.
  732.  
  733. TALLER doubles every line, making the picture twice as tall.
  734.  
  735.  
  736.  
  737. The TILT functions will make a portion of the image lean to the
  738. left or right. The functions will tilt various amounts. These
  739. functions will take text and make it ITALIC. 
  740.  
  741. RTILT 1 tilts to right, 1 dot for every 1 vertical dot. 
  742.  
  743. RTILT 2 tilts to right, 2 dot for every 1 vertical dots. 
  744.  
  745. RTILT 1/2 tilts to right, 1 dot for every 2 vertical dots. 
  746.  
  747. LTILT 1 tilts to left, 1 dot for every 1 vertical dot. 
  748.  
  749. LTILT 2 tilts to left, 2 dot for every 2 vertical dots. 
  750.  
  751. LTILT 1/2 tilts to left, 1 dot for every 2 vertical dots. 
  752.  
  753. OVERLAY is exactly like COPY, but the COPY is transparent. 
  754. This copies a range on top of an image without destroying 
  755. the picture underneath. 
  756.  
  757. INLAY is similar to overlay except the image is XORED onto the
  758. image underneath it. This gives interesting ghosting effects. The
  759. OPTIKS logo on the start up screen was created by inlaying an image
  760. of radiating lines onto the word OPTIKS. 
  761.  
  762. ZOOM allows you to edit fat bits. Use the SPACE bar to make a fat
  763. bit black, use the enter key to make it white. 
  764.  
  765. SCALE allows you to change the size of an image. First select the
  766. range of the image to be scaled then enter the new size of that
  767. range. 
  768.  
  769. The WHITE OUT option will "white-out" sections of a picture. 
  770.  
  771. The MIRROR selection will make a range in the picture a Mirror
  772. image. 
  773.  
  774. The NEGATE selection will make all black dots white and all white
  775. dots black. 
  776.  
  777. BLANK will make a portion of the picture black. 
  778.  
  779. FLIP will turn a range upside down. 
  780.  
  781. EDGE looks at the image and finds dots where a picture changes from
  782. black to white. If a dot is white and surrounded by white, it is
  783. ignored. The same is true of a black dot surrounded by black dots,
  784. but dots on an edge are turned white. This makes for very
  785. interesting special effects. It is best done several times so that
  786. the edges get edges. 
  787.  
  788.  
  789.  
  790. XOR LINE, is a way of simplifying the picture. Each line is turned
  791. black and only new dots which did not exist in the line above it
  792. are shown. This is useful to eliminate regions of white to make a
  793. cartoon effect. It does strange things to dithered data and may be
  794. useful as a special effect. 
  795.  
  796. CONTRST is a Contrast increaser. It examines a range and lightens
  797. the light areas and darkens the dark areas. 
  798.  
  799. GRAY examines every pixel on the screen and makes it a dot
  800. depending on the relative level of dark or light in the surrounding
  801. pixels. This evens out some dithered areas and makes them more
  802. uniform. 
  803.  
  804. SMOOTH is similar to GRAY, but it keeps a rolling average so that
  805. the total lightness or darkness of the picture does not change.
  806. Both gray and smooth tend to blur the image a little. 
  807.  
  808. WASH checks for white dots on a black background and black dots on
  809. a white background. If it finds lone dots, it will get rid of them.
  810. This is useful for cleaning up pictures with noise or dirty places
  811. with random dots. 
  812.  
  813. UNSTEP looks for "jaggies" which are areas with a sharp right
  814. angles. UNSTEP will fill in these areas and smooth out a range. Be
  815. aware that it will also take a place where you want a sharp angle
  816. and smooth it off. UNSTEP works best after you use DOUBLE (see
  817. above.) 
  818.  
  819. SHADE Makes every other dot black to give interesting faded looks.
  820.  
  821. DARKEN makes every other dot white. 
  822.  
  823. ERODE chips away at the white space on the disk and cleans up loan
  824. dots. 
  825.  
  826. DEPOS deposits dots on other dots to build up white and erode black
  827. space. 
  828.  
  829. CLIP erases all of a screen except the range. 
  830.  
  831.  
  832.  
  833. CHAPTER 11. How to Save an Image 
  834.  
  835. After you have read in an image and done whatever needed to be done
  836. to the image, it may be necessary to save the image. OPTIKS comes
  837. in a DEMO version called OKFREE and a private version called
  838. OKPRIV. If you are using the DEMO version which is distributed
  839. through shareware you will not be able to save your picture in any
  840. format except BASIC and the PCR format. BASIC formats are called
  841. BLOAD/BSAVE files or PUT/GET files. Both types of file can be used
  842. in programs written in basic. In addition, a lot of older programs
  843. use the BLOAD BSAVE option to store and retrieve images. PUT/GET 
  844. files are used by Fontasy. 
  845.  
  846. The PCR format is a way of saving pictures in a very compressed
  847. format. Only OPTIKS uses PCR files. Saving an image is done by
  848. selecting FILE/SAVE from the menu. You are given a list of possible
  849. file formats for saving. Select one by moving the highlighted bar
  850. to that item and pressing enter. You then must indicate the range
  851. of the area to save. 
  852.  
  853. This allows you to save a whole picture or just a part of the
  854. picture. Move the finger to the upper left hand side of the image
  855. and press enter and then move to the lower right hand side and
  856. press enter. Once the range is selected then the file selection
  857. menu will appear. If you want to save this as a new file then press
  858. the F9 key and type the name of the file. If you want to replace
  859. an existing file, point to the file and press enter. The hour glass
  860. will appear and the file will be saved. 
  861.  
  862.  
  863.  
  864. Chapter 12. Configuration options 
  865.  
  866. Although OPTIKS comes preconfigured for most applications, you may
  867. have a need to change one or more of the various options. You may
  868. also want to keep your configuration. OPTIKS will create a file
  869. called CONFIG.OK on the current directory whenever you ask to KEEP
  870. a configuration. The next time you start up OPTIKS, the program
  871. will look on the current directory for the CONFIG.OK file and use
  872. the information that it finds there. All of OPTIKS configuration
  873. options are found in the ENVIRN menu option from the main menu. The
  874. ENVIRN menu items are: 
  875.  
  876. CONFIG BREAK SCREEN MACROS ERASE 
  877.  
  878. CONFIG leads to the Configuration menu (see below). 
  879.  
  880. a. Screen Type 
  881.  
  882. OPTIKS is a graphics editor at heart, but unlike various systems
  883. which present a virtual device interface, OPTIKS uses what you've
  884. got as simply as it can. This means that your hardware dictates
  885. what you get. OPTIKS in no way claims to be WYSIWYG. OPTIKS is
  886. quite the reverse. OPTIKS will not display circles on your screen
  887. as round (unless by accident). You will see every dot in the
  888. graphic. Sometimes a package like GEM paint will show a different
  889. image than OPTIKS for the same file. This is because GEM Paint
  890. attempts to be WYSIWYG using its VDI (virtual device interface).
  891. OPTIKS shows the actual contents of a file and allows you to change
  892. it without an intermediate program trying to figure what it is you
  893. really mean. When you use OPTIKS to print, the same kind of thing
  894. happens. OPTIKS will print every dot that you tell it to, at the
  895. resolution that you specify. This will sometimes make for a
  896. distorted image, but OPTIKS puts the onus on you to control your
  897. environment. OPTIKS tries to figure the best screen mode when it
  898. starts up. The search for a proper screen goes like this: 
  899.  
  900. Check for CONFIG.OK 
  901.  
  902. Check for VGA 
  903.  
  904. Check for EGA 
  905.  
  906. Check for AT&T 6300 
  907.  
  908. Check for hercules 
  909.  
  910. Go to CGA mode 
  911.  
  912.  
  913.  
  914. It's possible to wind up in the wrong mode if you are on a 
  915. non-standard video that does not show up as VGA or CGA and 
  916. looks like Hercules. This happens also when you are in a VGA card
  917. hooked up to a monochrome monitor (such as the Nec Multisync GS).
  918. The cure is to start up with the command line string of ESICM for
  919. example: 
  920.  
  921. OKPRIV ? 
  922.  
  923. This will place you in CGA mono mode. From this screen you can go
  924. back and select IBM EGA 640*350 or whatever mode works best for
  925. you. The SCREEN option which is accessed from the ENVIRN menu
  926. controls the display screen type. OPTIKS makes a best guess shot
  927. at determining a screen when you start up. This is not always
  928. correct. You can select a screen type which OPTIKS will force
  929. itself to use when it starts up. You can also use the screen option
  930. to see what an image looks like on other systems. 
  931.  
  932. WARNING: Selecting a screen type incompatible with your hardware
  933. could cause OPTIKS to freeze or cause monitor damage. Actual
  934. hardware damage is possible but extremely unlikely. Running OPTIKS
  935. on a an IBM Monochrome Adapter with no graphics ability can cause
  936. OPTIKS to damage the monitor. 
  937.  
  938. If you know a computer has no graphics ability then there is no
  939. point in even attempting to run OPTIKS. If you select a screen
  940. option which causes the screen to blank out, but the Escape key
  941. still causes a blip sound every other time it is pressed, you can
  942. still exit OPTIKS without a problem. Press Ctrl-Break. Press Q and
  943. then Y. This will always work to exit you from OPTIKS. This is not
  944. the recommended way to exit OPTIKS, but it should always work.
  945. Ctrl-Break will upset some DOS versions so use it only to break out
  946. of OPTIKS. 
  947.  
  948.  
  949.  
  950.               ╔══════════════════════════════════════╗
  951.               ║      VIDEO CARD SELECTION            ║
  952.               ║   Make a Selection and Press Enter   ║
  953.               ║        Press Esc to Exit             ║
  954.               ╚══════════════════════════════════════╝
  955.     AMDEK or WYSE 1280 Black and White 640*400 mode
  956.       ╔══════════════════════════════════════════════════════╗
  957.       ║ AMDEK         EGA COLOR    MAXXON    VGA             ║
  958.       ║ ATI PRISM     EV-673       MCGA      VIDEO 7         ║
  959.       ║ ATI VGA       GEN 5200     NEC       VIDEO 7         ║
  960.       ║ ATI VIPS      GENIUS       ORCHID    VIDEO 7         ║
  961.       ║ AT&T 6300     GENOA VGA    PARADISE                  ║
  962.       ║ CGA MED       GENOA VGA    PARADISE                  ║
  963.       ║ CGA HIGH      GENOA VGA    STB                       ║
  964.       ║ COMPAQ        HERCULES     TOSH 3100                 ║
  965.       ║ EGA MONO      LOGIX        TSENG                     ║
  966.       ╚══════════════════════════════════════════════════════╝
  967.  
  968. Figure 4. Video Selection Menu 
  969.  
  970. OPTIKS supports CGA medium and high resolution modes, EGA and VGA
  971. graphics modes, Hercules and AT&T and a few Enhanced EGA and VGA
  972. modes. Although OPTIKS does not support color fully, it is possible
  973. to load and view color pictures by using the PLANES options. 1
  974. plane = 2 colors, 4 planes = 16 colors. Color modes are for viewing
  975. graphics. Do not try image functions on a color picture. Do not try
  976. to save a color image to a black and white format (eg. Color PCX
  977. to MAC). Do not try to load a black and white image while planes
  978. are set to 4. 
  979.  
  980.  
  981.  
  982. IBM VGA supports the two standard VGA graphics modes for 640 by 400
  983. These modes are useful in that they offer a better aspect ratio
  984. than other screen modes. Circles tend to be round in these modes. 
  985.  
  986. AT&T is for the AT&T 6300 mode monochrome graphics. This graphics
  987. mode is the reason why many people purchased AT&T 6300 systems
  988. which work well with OPTIKS. However, OPTIKS scans for the 6300
  989. BIOS signature and will send you into 6300 automatically. If you
  990. disable the 6300 screen in order to put another graphics card in,
  991. OPTIKS will still think that you are a 6300 and this can cause
  992. OPTIKS to go into the wrong mode. You must use the OKPRIV ? command
  993. line to get to IBM CGA MONO mode to bypass the automatic screen
  994. detect and then select the correct screen mode. Use KEEP so that
  995. in the future OPTIKS will not try to use the AT&T mode. 
  996.  
  997. HERC is Hercules Graphics Mode. There is no standard way to detect
  998. a Hercules card. The standard schemes do not always detect clone
  999. Hercules cards. OPTIKS looks to see if the Hercules Graphics memory
  1000. is available and if it finds something then will assume that you
  1001. may have a Hercules card. If you start up in monochrome text mode
  1002. and you don't have an EGA or VGA or AT&T, the assumption must be
  1003. that you have a Hercules card. This assumption is sometimes wrong.
  1004. You can use the OKPRIV ? to start OPTIKS if you have a screen which
  1005. can use the CGA modes (which is almost everyone) to bypass the
  1006. Hercules testing. 1280 is the Wyse or Amdek 1280 system. This
  1007. system will start up correctly in CGA mono mode. Use this option
  1008. to enter the 640*400 mode of this system. 
  1009.  
  1010. COMPAQ is for the Compaq portable computers which use AT&T type
  1011. graphics modes. This selection will not scan for the AT&T bios
  1012. signature. 
  1013.  
  1014. TOSHIBA is for the Toshiba 3100 special graphics modes. 
  1015.  
  1016.  
  1017.  
  1018. b. virtual screen width 
  1019.  
  1020. OPTIKS starts up by default with a virtual screen width of 1024
  1021. pixels. This is fine for most small graphics files. Some larger
  1022. graphics will be cut off on the right edge because the width of the
  1023. OPTIKS work- space is only 1024. To increase the virtual screen
  1024. width enter: 
  1025.  
  1026.  /ECV 
  1027.  
  1028. This is Environment Config Virtual. You will be given the following
  1029. menu: 
  1030.  
  1031. 1024 2048 4096 8192 EMS DISPLAY 
  1032.  
  1033. You would select a virtual screen width from 1024 to 8192 by moving
  1034. to the correct item and pressing enter. EMS allows for control over
  1035. the allocation of EMS memory and DISPLAY will show you your memory
  1036. allocation. 
  1037.  
  1038. One of the consequences of changing the virtual screen width is
  1039. that the work-space is erased. Another consequence is that your
  1040. virtual work-space will be shortened. OPTIKS only has a limited
  1041. amount of memory to work with and if you use more to make the
  1042. work-space wider then some will be taken away from the length. You
  1043. must use the smallest width possible to hold your graphics and then
  1044. you will have the most length possible. 
  1045.  
  1046. c. EMS memory 
  1047.  
  1048. The EMS option from the Environment Config Virtual menu controls
  1049. how EMS is allocated. Normally OPTIKS checks for free EMS memory
  1050. and grabs any that is not being used for itself. OPTIKS will
  1051. release this memory when you quit from the program. There may be
  1052. times when you do not want OPTIKS to use the EMS memory or you wish
  1053. to limit the amount of EMS memory that OPTIKS uses. 
  1054.  
  1055. ALL 128 256 12 MEG B-1.5M C-2M D-3M E-4M UALLOC 
  1056.  
  1057. ALL is all available EMS memory. 
  1058.  
  1059. 128 to 4M are the various chunks you can force OPTIKS to take. If
  1060. OPTIKS can't take the amount specified, it won't take any. UNALLOC
  1061. is the option which unallocates any existing EMS memory. You must
  1062. allocate any memory OPTIKS has previously allocated in order to
  1063. allocate EMS memory differently. 
  1064.  
  1065.  
  1066.  
  1067. d. Miscellaneous Options 
  1068.  
  1069. The CONFIG menu bar looks like this: 
  1070.  
  1071. VIRT TALK SCREEN PRINTER KEEP DISPLAY BLIP 
  1072.  
  1073. VIRT and SCREEN have been discussed. PRINTER and KEEP are discussed
  1074. below. This section includes TALK and BLIP which are the kinds of
  1075. things that programmers do when they are not being watched. 
  1076.  
  1077. TALK is an experiment in using the PC speaker for voice. This only
  1078. works on 4.77 Mhz PC's. If you have a faster PC the voice is not
  1079. really recognizable. The TALK function is set to echo through the
  1080. speaker a letter for each letter pressed. Try it, say that's
  1081. interesting, and then turn it off. 
  1082.  
  1083. BLIP is a sound affect that sounds a little like a Star Wars sound.
  1084. It is to inform you when significant events occur. If you work in
  1085. a quiet office where the sound of OPTIKS annoys those around you,
  1086. it can be turned off. 
  1087.  
  1088. DISPLAY shows you many of the miscellaneous configuration options. 
  1089.  
  1090. e. Printer options 
  1091.  
  1092. OPTIKS can print out graphics on a variety of printers. OPTIKS is
  1093. not intended for use in printing except as a means of producing a
  1094. draft quality image. Other programs print much better than OPTIKS.
  1095. OPTIKS should be used with desk top publishing programs or other
  1096. graphics programs to make those programs work better. You might
  1097. want to use OPTIKS printing to produce an idea of what an image
  1098. will look like when included in other applications. OPTIKS is
  1099. generally faster than other programs because it just prints what
  1100. it has without trying to translate the image to fit on your output.
  1101. OPTIKS can be considered a "Quick and Dirty" approach to printing.
  1102. When you choose PRINT from the OPTIKS main menu, you will have to
  1103. decide between: 
  1104.  
  1105. PRINTER FILE CAPCard 
  1106.  
  1107.  
  1108.  
  1109. Choose the printer option if you want to go directly out to a
  1110. printer port. FILE is if you want the output of OPTIKS to go to a
  1111. file. You can use this if you want to use OPTIKS output with the
  1112. INCLUDE program which is on the OPTIKS Shareware diskette or you
  1113. want to print the file later. You can copy the printer file to the
  1114. printer by using the DOS COPY command. If you save your printer
  1115. output in a file called PR-OUT.PRT then you would enter: 
  1116.  
  1117. COPY/B PR-OUT.PRT LPT1: 
  1118.  
  1119. The /B option tells DOS not to stop at the End-of-File marker. In
  1120. graphics, the End-of-File marker might appear naturally as part of
  1121. an image pattern and should not be interpreted as the actual end
  1122. of file. 
  1123.  
  1124. CAPCard is a LaserMaster CAPCard which is a card that goes into
  1125. your PC and directly drives most laser printers. The card is many
  1126. times faster than a normal laser printer and is a cost effective
  1127. way of upgrading inexpensive laser printers to HPCL and even
  1128. Postscript in an environment where speed is important. The CAPCard
  1129. option will not work if the DJET driver is used. You must disable
  1130. DJET and load in the other driver to make OPTIKS work correctly
  1131. with a CAPCard. At publication time I am being mailed a CAPCard for
  1132. evaluation and I hope to have the bugs in this section worked out. 
  1133.  
  1134. f. Saving the CONFIG.OK file 
  1135.  
  1136. OPTIKS can KEEP options by selecting the KEEP function from the
  1137. ENVIRONMENT/CONFIG menu. The options are kept in a small file
  1138. called CONFIG.OK. This file contains all of the options that you
  1139. have set including all macros. When OPTIKS starts up it looks on
  1140. the current directory for the CONFIG.OK file and will use one when
  1141. it finds one. 
  1142.  
  1143.  
  1144.  
  1145. g. Debug Break Points 
  1146.  
  1147. The BREAK option can be accessed by pressing Ctrl-B when in view
  1148. mode and allows for debug check points. This is only useful if you
  1149. are in competition with OPTIKS and need to know how OPTIKS does
  1150. something. You can set one of the break points by selecting a break
  1151. point and an INT 3 will be issued just before entering that
  1152. function. If you are in DEBUG.COM or other debugger, you can run
  1153. OPTIKS until the interrupt is encountered and single step through
  1154. a routine. 
  1155.  
  1156. BREAK is the most dangerous thing you can fool with in OPTIKS.
  1157. OPTIKS has reassigned some of the interrupts when it loads so make
  1158. sure that you do not quit out of the debugger. If you do not exit
  1159. OPTIKS through the /QY option, you computer will hang up requiring
  1160. a red switch restart. 
  1161.  
  1162.  
  1163.  
  1164. CHAPTER 13 - Draw functions. 
  1165.  
  1166. OPTIKS allows you to draw LINES, BOXES, ELLIPSES and POINTS. It
  1167. will allow (in a future release) to fill. There is no "undo" in
  1168. OPTIKS so be careful and save you work before doing anything
  1169. drastic.
  1170.  
  1171. LINES - these are classic rubber band lines. You draw a line by
  1172. pointing to one end of a line and pressing enter key, and then
  1173. moving to the other end of the line and pressing enter key. Before
  1174. pressing the enter key for the second time, you can "float" the
  1175. line, by pressing the delete key. Pressing the delete key again
  1176. will "freeze" the line and go back into rubber band mode. Float
  1177. will work on all drawing routines as well as all ranges. 
  1178.  
  1179. BOXES - Selecting BOX will allow you draw rectangles and squares.
  1180. First you point to the upper left hand corner of the box and then
  1181. stretch out a box by moving the lower right hand corner of the box.
  1182.  
  1183. ELLIPSES - Circles and ellipses can be drawn by pointing to the
  1184. center of the ellipse and then stretching out the ellipse by moving
  1185. the finger. A circle is a special ellipse. Since different screens
  1186. have different aspect ratios, there is no way to be sure that you
  1187. have a circle right. 
  1188.  
  1189. POINT - this is like the old toy "etch-a-sketch". Pressing enter
  1190. starts the line and pressing enter again stops it. 
  1191.  
  1192. SHADE - This determines a shade pattern that will be used in
  1193. drawing the drawing lines, and they will be used for FILL when that
  1194. is done. There are about a dozen or so patterns and they cover all
  1195. of the standard types and a few odd ones. They are 16 * 8 dot
  1196. patterns.
  1197.  
  1198.  
  1199.  
  1200.               ╔══════════════════════════════════════╗
  1201.               ║          SHADE PATTERNS              ║
  1202.               ║   Make a Selection and Press Enter   ║
  1203.               ║        Press Esc to Exit             ║
  1204.               ╚══════════════════════════════════════╝
  1205.     Solid Black
  1206.       ╔══════════════════════════════════════════════════════╗
  1207.       ║ BLACK         HERRING                                ║
  1208.       ║ BRICK         HAPPY                                  ║
  1209.       ║ BUGS          HEX                                    ║
  1210.       ║ CHECKERS      FHORIZ                                 ║
  1211.       ║ CONFETTI      LIPS                                   ║
  1212.       ║ DIAG          RADIATE                                ║
  1213.       ║ DOLLAR        SM CHECKS                              ║
  1214.       ║ EYES          VERT                                   ║
  1215.       ║ GRAY          WHITE                                  ║
  1216.       ╚══════════════════════════════════════════════════════╝
  1217.  
  1218. Figure 5. Shade Pattern Selection Menu. 
  1219.  
  1220.  
  1221.  
  1222. WIDTH - This selects how many dots wide a line can be drawn as. A
  1223. line can be 1 to 8 dots. (when I say line I mean the lines of a box
  1224. or an ellipse as well as rubber bands or points.) 
  1225.  
  1226. APPLY - this controls how a dot will be applied to the picture. If
  1227. you are drawing a white line on a white background you cannot see
  1228. the line. With apply, you can change the method and color of point
  1229. writing. The choices are: 
  1230.  
  1231.    PUNCH - this means punch a hole and put a dot there no matter
  1232.            what the background was. This puts a white dot in on 
  1233.            the picture. 
  1234.  
  1235.    XOR   - This puts a white dot on black points and a black dot
  1236.            on white points. Lines drawn with XOR will always be 
  1237.            visible. 
  1238.  
  1239.    OR    - This lays in or merges with the background. It does not
  1240.            erase what was there ever, but merges with it. 
  1241.  
  1242.    NEG PU - Negative punch - puts a black dot down. 
  1243.  
  1244.    NEG XOR- Puts a Black dot down using the xor rules. (I am not
  1245.             sure that this does anything!) 
  1246.  
  1247.    NEG OR -  ORs a black dot down. 
  1248.  
  1249.  
  1250.  
  1251. CHAPTER 14 - Scanning. 
  1252.  
  1253. OPTIKS supports Canon IX-12 scanners using the Canon supplied
  1254. software drivers. (see appendix G. for switch settings on Canon
  1255. card and software installation.) 
  1256.  
  1257. The way scanning works is as follows: 
  1258.  
  1259. Step 1 - select a range. This is the area where the scan will go.
  1260. You can press F2 after selecting the range option and the scan will
  1261. use up the whole work space as much as possible. 
  1262.  
  1263. Step 2 - Select a starting point. This is the distance down the
  1264. page that you want to start the scan. This is the distance down the
  1265. piece of paper, not the screen, although I am using the finger to
  1266. select this value. When you select starting point, press ALT-I to
  1267. get the index on the screen so you can get a feel for how many dots
  1268. down the page yo will be starting. Normally you would press the
  1269. HOME key and go to the upper left hand corner so that you would
  1270. scan the whole piece of paper. 
  1271.  
  1272. Step 3 - Select OPTIONS. You must select how many DPI you want to
  1273. scan at and at what density etc., to scan at. 
  1274.  
  1275. Step 4 - Start the scan. The scanner will pull the paper through
  1276. the scanner and the picture will be transferred to the OPTIKS work
  1277. space. Press ALT-C to view the progress of the scan if it is slow.
  1278. Every time you press ALT-C while the Hour Glass is on the screen
  1279. the screen will clear and any work so far will be displayed. 
  1280.  
  1281.  
  1282.  
  1283. CHAPTER 15 - Mandelbrots. 
  1284.  
  1285. Mandelbrots are found in the DRAW menu of OPTIKS. They are not a
  1286. true graphics editing function, but OPTIKS is a convenient platform
  1287. for creating a viewing Mandelbrot sets. 
  1288.  
  1289. Mandelbrots are those neat looking germ like swirls that appear
  1290. from time to time on the covers of computer magazines. They seem
  1291. to sell magazines, but I doubt if anyone will buy OPTIKS just for
  1292. the Mandelbrot set. 
  1293.  
  1294. OPTIKS uses integer arithmetic. I once was asked if I supported the
  1295. math coprocessor. I can go faster than the coprocessor using
  1296. integers for the kind of arithmetic that graphics needs. OPTIKS
  1297. produces Mandelbrots about 10 times faster than "C" language
  1298. floating point and about as fast a coprocessor in calculating
  1299. Mandelbrots. 
  1300.  
  1301. A section of the Mandelbrot set 1024 by 1024 takes about 3 hours
  1302. on my 20 mhz 80386 Dyna. This would take two days on a 4.77 PC.
  1303. Using "C" language floating point this would take two weeks on the
  1304. PC. 
  1305.  
  1306. In addition to speed OPTIKS offers the ability to create truly huge
  1307. landscapes (limited only by patience and the stability of the power
  1308. lines.) OPTIKS allows you to produce 16 color sets or Dither the
  1309. sets to black and white. Dithered Mandelbrots look marvelous. They
  1310. have a 3D texture that is great and they print out on laser
  1311. printers at 300 DPI with amazing clarity. 
  1312.  
  1313. Mandelbrot Strategy. 
  1314.  
  1315. Step 1 - Select COLOR Planes. If you are going to create color
  1316. Mandelbrots, you must select COLOR/PLANES/4 before you select
  1317. RANGE. RANGE will use the color method to calculate the Mandelbrot
  1318.  
  1319. Set parameters. If you change color planes, you must reselect the
  1320. range. 
  1321.  
  1322. Step 2 - Select RANGE. Please do step 1 first. (It seems strange
  1323. to have to write that last sentence, but I know I will get phone
  1324. calls about this.) Range is the BOX that you will fill in with the
  1325. Mandelbrot landscape. Selecting a small box assures that you won't
  1326. have to wait very long. When you are exploring always use a small
  1327. box, you won't get much detail, but at least you will get something
  1328. in reasonable time. 
  1329.  
  1330.  
  1331.  
  1332. Step 3 - Enter PMAX. This is the left hand coordinates of the
  1333. portion of the Mandelbrot set that you will be viewing. 
  1334.  
  1335. Step 4 - Enter PMIN. This is the right bound. 
  1336.  
  1337. Step 5 - Enter QMIN. This is the bottom bound. 
  1338.  
  1339. Step 6 - Enter QMAX. This is the top bound. 
  1340.  
  1341. I use the following for a take off point. PMAX= -.74 PMIN= -.75
  1342. QMAX= .12 QMIN= .113 This is from the cover of a recent Micro C
  1343. magazine. It has some neat curls in it and you have enough room for
  1344. some zooms. 
  1345.  
  1346. You must also enter: 
  1347.  
  1348. ITERATIONS. This is a number larger than 100. The larger the
  1349. number, the slower the program will run, but you will get more
  1350. color information in the darker areas of the picture. This will
  1351. generally give you crisper information. This must be less than
  1352. 32000. 
  1353.  
  1354. MODULUS. This is the Mandelbrot "blow-up" point. It should be over
  1355. 1000, but not larger than 16000 due to limits of the integer
  1356. arithmetic that I use. The lower the number the faster the set will
  1357. run, but higher number give more detail and less noise.  The method
  1358. that I use to generate the sets produces some noise in the
  1359. "lowlands" which are the flat uniform areas out away from the
  1360. action. The action itself comes out well. 
  1361.  
  1362. You may select if you like a color method. This affects the way
  1363. OPTIKS treats the colors. Normally, the count of iterations at blow
  1364. up is used to determine the color. OPTIKS allows you to shift this
  1365. value to the right dividing it by 2. Colors are interpreted 
  1366. modulo 16 so that colors start counting over again after 15. 
  1367.  Low shift values give small regions of color which repeat. Large
  1368. values of shift give broader regions of color which do not repeat
  1369. as often. Low values give "busy" highly detailed, but difficult to
  1370. view landscapes. (The look very grainy). High values give better
  1371. views, but some detail is lost. 
  1372.  
  1373. Dither uses a process of converting colors to patterns of dots
  1374. which comes out very well in OPTIKS. Dither and color planes are
  1375. mutually exclusive. You can't dither in color. 
  1376.  
  1377.  
  1378.  
  1379. I get best results using dither and a shift of 2 or three. 
  1380.  
  1381. The strategy continues. 
  1382.  
  1383. Select a small range, and all of the parameters and GO. Wait a
  1384. while watching the hour glass. Press Alt-C and the screen will
  1385. clear, showing work in progress. When you have seen enough press
  1386. Esc to stop the works. 
  1387.  
  1388. ZOOM. Once you get a picture you can ZOOM (or Pan) the picture.
  1389. Since OPTIKS has a work space much bigger than the image you can
  1390. zoom in on a section that you did not actually paint. Or you can
  1391. specify a zoom area bigger than the original picture and this will
  1392. Pan (or step back). Zooming recalculates the Pmax, Pmin, Qmax and
  1393. Qmin values. The ZOOM function will remember what your last range
  1394. was and use that for the calculations. The area you ZOOM does not
  1395. have to be completely in or out of the original range. You can zoom
  1396. into areas that you did not completely paint. 
  1397.  
  1398. Do not change the range before zooming. The correct order is RANGE,
  1399. GO, and ZOOM then GO. If you change the range then you must select
  1400. GO and then ZOOM in on the new range. 
  1401.  
  1402. Do not ZOOM in forever. The smallest value that the arithmetic can
  1403. express in OPTIKS is about .00000001. If you go too deep you will
  1404. hit this limit and get a screen of white space. 
  1405.  
  1406. Keep your ranges and zooms roughly square so that you don't have
  1407. to worry about aspect ratios. If you have funny shaped zooms you
  1408. will have squashed pictures. 
  1409.  
  1410. When you get a picture that you like then make a very large range
  1411. and select go. Come back a few hours (or days) later and save the
  1412. results. 
  1413.  
  1414.  
  1415.  
  1416. Appendix A. Common Problems 
  1417.  
  1418. a) Get a blank screen after typing OKFREE or OKPRIV 
  1419.  
  1420. It is quite possible that OPTIKS is getting confused over what type
  1421. of video card you have attached and what kind of screen that it is
  1422. attached to. Sometimes, if your motherboard switch settings are set
  1423. to monochrome and you have and EGA or VGA card, OPTIKS will try and
  1424. set you to Hercules mode. Even though you card may support a
  1425. Hercules setting, the board may not want to shift into Hercules
  1426. emulation. Since there is no standard way to set Hercules  graphics
  1427. mode, it is possible that you card my not respond. 
  1428.  
  1429. Other graphics combinations can through off the OPTIKS
  1430. identification routines. If you have an EGA or VGA or a card which
  1431. supports CGA graphics and OPTIKS is giving you a blank screen then
  1432. try entering:
  1433.  
  1434.     OK ?
  1435.  
  1436. Where OK is the name of you version of OPTIKS (OKFREE or OKPRIV).
  1437. The question mark will tell OPTIKS to go directly to CGA high
  1438. resolution mode without trying to check on video card type.
  1439.  
  1440. Once you get into CGA mode use the /ESV option to select a video
  1441. card which you can support and try it. Once you get the best
  1442. resolution you can then use the KEEP menu item to save your
  1443. config.ok.
  1444.  
  1445. Sometimes it helps to enter MODE CO80 from the DOS prompt and then
  1446. OPTIKS has a much easier time identifying your video card.
  1447.  
  1448.  
  1449.  
  1450. b) Can't save a file. 
  1451.  
  1452. I frequently get calls with a very angry person saying they paid
  1453. a disk copying company $3.00 to get OPTIKS and now they can't save
  1454. in any of the formats that they want to save in. I hear the word
  1455. Rip-Off a lot.
  1456.  
  1457. Let me explain about the real world. There Ain't No Such Thing As
  1458. A Free Lunch. I have produced over 80 shareware programs. Except
  1459. for OPTIKS I receive very little. On a good week I could receive
  1460. ten or fifteen dollars (not even beer money). This is on programs
  1461. such as FastFind and TXT2COM which have been reviewed in national
  1462. magazines and given high marks. The great-grandfather of OPTIKS was
  1463. FMAC which is still one of the most highly circulated programs ever
  1464. put on BBS's and I receive nothing for it. As soon as I crippled
  1465. OPTIKS I started to make money. It is sad but true. TANSTAAFL.
  1466.  
  1467. I receive nothing from companies which copy my programs without
  1468. permission and tout OKFREE as being fully functional. They
  1469. distribute version as much as two years out of date. I have never
  1470. given permission to anyone except "Public Software Library" to
  1471. distribute my shareware. I am the one that gets the phone calls a
  1472. two in the morning.
  1473.  
  1474. If OPTIKS refuses to save in a format other than PCR or Basic, then
  1475. you have the free version. Send me $129.95 and you will get the
  1476. latest fully functional version of OPTIKS.
  1477.  
  1478. If you paid the money and are having problems with OKPRIV then I
  1479. apologize for the emotional outburst I just finished writing. Your
  1480. disk may be full or write protected, or you have found a legitimate
  1481. (or illegitimate) bug and I need to know. Give me a call at (914)
  1482. 623-4161 so I can get to work.
  1483.  
  1484.  
  1485.   
  1486. c) Printer prints in negative. 
  1487.  
  1488. There is an option under printer options that allows you to set
  1489. NEGATE or negative. Some pictures appear on the screen correctly
  1490. but print out awful, the best thing to do is to set the NEGATE off
  1491. and print the picture again.
  1492.  
  1493. d) Right side of image is cut off.
  1494.  
  1495. You have not set the virtual screen width. The work space is only
  1496. 1024 pixels wide when the OPTIKS starts up. If you are dealing with
  1497. 400 DPI images it is time to set the Virtual width as wide as
  1498. possible (perhaps 4096) to get the whole picture in. 
  1499.  
  1500. e) Bottom of image is cut off. 
  1501.  
  1502. The size of an image that can fit into OPTIKS is limited by your
  1503. machines memory. If you have EMS memory you can fit BIG pictures
  1504. into OPTIKS work space. If you have low memory and no EMS optiks
  1505. cannot fit the whole picture in and gives up reading the image when
  1506. you run out of room to store it. I would suggest that you get out
  1507. OKEMS and try it. OKEMS should be on the OPTIKS distribution
  1508. diskette and it is available for download at PC-Rockland.
  1509.  
  1510.  
  1511.  
  1512. f) AutoCad or GEM draw problems.
  1513.  
  1514. Unfortunately OPTIKS does not make any attempt to look at what is
  1515. being written out before it is written out. A pixel image will
  1516. always be a pixel image to OPTIKS. If you try to write out a file
  1517. in a draw format, what you get is horizontal lines which
  1518. approximate the raster lines of the image. These work OK in GEM and
  1519. AutoCad and even Ventura, but they take up much memory, and a large
  1520. complex image will blow Acad out of the water, and GEM and Ventura
  1521. could refuse to load very large pictures. 
  1522.  
  1523. I am afraid that if you really need AutoCad or GEM images that you
  1524. should get Corel Draw or Micrographics Designer and do the job
  1525. right. The OPTIKS images are good for putting raster images into
  1526. AutoCad drawings. You can get realistic people and trees into the
  1527. picture as long as they are small, but if you need to convert a
  1528. large image into a real drawing then use one of the products
  1529. designed to that.
  1530.  
  1531. DRAW file formats are basically incompatible with bit mapped
  1532. images. OPTIKS tries to allow a limited transfer of information to
  1533. the draw formats by drawing horizontal lines or dots that
  1534. correspond to the pixels in the image. OPTIKS will translate WHITE
  1535. dots on the screen to BLACK dots and lines in the draw format.
  1536. OPTIKS ignores the black areas of the screen. DRAW formats are
  1537. saved in the same way that normal files are saved (see SAVING files
  1538. if you have not already done so). Make the saved range as small as
  1539. possible. Draw formats tend to be very large, especially AutoCAD
  1540. DXF files. If you are using AutoCAD use DXB or SLD files to save
  1541. space and speed processing. When you read the file into another
  1542. program, the files may have to be sized again. Ventura will
  1543. automatically size SLD and GEM Draw, but AutoCAD will have some
  1544. minor problems with the DXF and DXB. You will have to use the ZOOM
  1545. command in AutoCAD to get the picture right. DXF and DXB files use
  1546. whatever color is defined for lines so make sure that you don't
  1547. have a black screen and black lines or you won't see anything. 
  1548.  
  1549.  
  1550.  
  1551. g) Can't scan. 
  1552.  
  1553. There are two reasons why OPTIKS would not scan. First you must
  1554. have a Canon Scanner with the IX12 handler that comes with you
  1555. scanner. You can get the latest version of the handler off of PC-
  1556. Rockland. Canon has given me permission to distribute it to paid
  1557. OPTIKS users. The second reason could be that the switch settings
  1558. on the scanner are wrong. If you have and EGA or VGA you must
  1559. change the switches on you scanner card. Please refer to the
  1560. section on scanning and the appendix of scanner switch settings.
  1561.  
  1562. You must also set all of the options, including the range and
  1563. starting point of the scan in order to get the scanner to work.
  1564. Please check these settings and try again.
  1565.  
  1566. If you have 386max or QEMMS or DoubleDos going, make sure that they
  1567. know about the scanner memory frame.
  1568.  
  1569. h) Can't read a GIF file.
  1570.  
  1571. OPTIKS can read NON-INTERLACED gifs up to 16 colors. OPTIKS will
  1572. not be able to read 256 color GIFS and it will read interlace GIFS
  1573. all scrambled. Use VPIC by Bob Montgomery. I have not released
  1574. color OPTIKS because VPIC is still a better product.
  1575.  
  1576.  
  1577. i) Can't read a TIFF file.
  1578.  
  1579. OPTIKS can not read gray scale tiffs. OPTIKS will not read tiffs
  1580. with proprietary compression schemes and OPTIKS cannot read the few
  1581. group 4 CCITT compression tiffs around.
  1582.  
  1583. j) Can't read a Printshop Graphic file.
  1584.  
  1585. OPTIKS can read only a few types of PrintShop graphics. It can't
  1586. read every graphic on the disk. There is now sure way to be able
  1587. to read them all and the new PrintShop is out now with new formats
  1588. that I have not looked at yet. 
  1589.  
  1590. k) Can't read a PC Paint or Grasp file. 
  1591.  
  1592. GRASP and PC PAINT use a funny way of reading files - from the
  1593. bottom up. I know how to read the files, but I am too lazy to
  1594. change thousands of lines of code to read a very few files. There
  1595. are Utilities on BBS's which will convert the PIC files to PCX and
  1596. back.
  1597.  
  1598.  
  1599.  
  1600. Appendix B. Menu Tree
  1601.  
  1602. FILE
  1603.    READ
  1604.    SAVE
  1605.    MERGE
  1606.    LIST
  1607.    INFO
  1608.    CHECK
  1609. ENVIRON
  1610.    CONFIG
  1611.       VIRT
  1612.          1024
  1613.          2048
  1614.          4096
  1615.          8192
  1616.          EMS
  1617.             ALL
  1618.             128
  1619.             256
  1620.             512
  1621.             MEG
  1622.             B-1.5M
  1623.             C-2M
  1624.             C-3M
  1625.             D-4M
  1626.             UNALLOC
  1627.          DISPLAY
  1628.       SCREEN
  1629.          VIDEO
  1630.          COLOR
  1631.             1 PLANE
  1632.             4 PLANES
  1633.       PRINTER - See printer config options
  1634.       KEEP
  1635.       DISPLAY
  1636.       BLIP
  1637.          ON
  1638.          QUIET
  1639.       RANGE
  1640.          BOX
  1641.          LINE
  1642.    SCREEN - see above
  1643.    MACROS
  1644.       1 TO 9
  1645.    ERASE
  1646.       YES
  1647.       NO
  1648.  
  1649.  
  1650. PRINT
  1651.    PRINTER
  1652.    FILE
  1653.    CAPCARD
  1654.       RANGE
  1655.       PAGE
  1656.       LINEF
  1657.       GO
  1658.       CONFIG
  1659.          MODEL
  1660.             DOT
  1661.                IBM
  1662.                EPSON
  1663.                8510
  1664.                TOSHIBA
  1665.                PROPRT
  1666.                24PROPRT
  1667.                GEMINI
  1668.             LASER
  1669.                HP LASERJET
  1670.                RICOH
  1671.                CANON
  1672.          PORT
  1673.             LPT
  1674.                1 TO 3
  1675.             COM
  1676.                BAUD
  1677.                PARITY
  1678.                INIT
  1679.                1 TO 3
  1680.          DENSITY
  1681.             1 TO 6
  1682.          ORIENT
  1683.             PORTR
  1684.             LAND
  1685.          NEGATE
  1686.             NEGATE
  1687.             POSIT
  1688.          STRIKES
  1689.             ONE
  1690.             TWO
  1691.       SPACE
  1692.  
  1693. IMAGE
  1694. DRAW
  1695.    LINE
  1696.    ELLIPSE
  1697.    BOX
  1698.    FILL
  1699.    POINT
  1700.    TEXT - See type options
  1701.    SHADE
  1702.    WIDTH
  1703.      1 TO 8
  1704.    APPLY
  1705.       PUNCH
  1706.       XOR
  1707.       OR
  1708.       NEG PU
  1709.       A-NEGX
  1710.       B-NEG0
  1711.    MANDEL
  1712.        RANGE
  1713.        PMAX
  1714.        PMIN
  1715.        QMAX
  1716.        QMIN
  1717.        ITER
  1718.        MODULUS
  1719.        COLORS
  1720.           0 TO 4
  1721.           DITHER
  1722.              OFF
  1723.              ON
  1724.           PLANES
  1725.              1
  1726.              4
  1727.        GO
  1728.        ZOOM
  1729. TYPE
  1730.    TYPE
  1731.    FONT
  1732.       0 TO 4
  1733.    SCALE
  1734.       HALF
  1735.       1, 2 OR 4
  1736.    COLOR
  1737.       W ON B
  1738.       B ON W
  1739.       1 - OR
  1740.       2 - OR
  1741.       3 - AND
  1742.       4 - AND
  1743.       5 - XOR
  1744.       6 - XOR
  1745. SCAN
  1746.    IX12
  1747.    PRINCETON
  1748.       RANGE
  1749.       LOCATE
  1750.       DEFAULT
  1751.          HREDUC
  1752.             NON
  1753.             HALF
  1754.             QUARTER
  1755.          RESOL
  1756.             75DPI
  1757.             150DPI
  1758.             200DPI
  1759.             300DPI
  1760.          MODE
  1761.             NORMAL
  1762.             2-OR
  1763.             DITHER
  1764.          DENSITY
  1765.             STANDARD
  1766.             DARK
  1767.             LIGHT
  1768.          NEGATE
  1769.             POSIT
  1770.             NEG
  1771.       SCAN
  1772. QUIT
  1773.  
  1774.  
  1775.  
  1776. Appendix C. Converting a MAC file to a PCX file.
  1777.  
  1778. The following is a step by step procedure to convert an 
  1779. Apple MacPaint file into a ZSoft PC Paintbrush PCX file. This is
  1780. a useful example because it does the kind of things that most
  1781. people will want to do with OPTIKS. 
  1782.  
  1783. Before starting up OPTIKS make sure that the OPTIKS program is
  1784. available and that you have the disk with MAC files on it. You may
  1785. want to copy the MAC files onto your hard disk into an OPTIKS
  1786. subdirectory along with the OPTIKS program. Start up the OPTIKS
  1787. program. Enter OKPRIV and press return. If you have renamed the
  1788. OKPRIV.EXE program to OK.EXE you can start up OPTIKS by entering
  1789. OK. 
  1790.  
  1791. The main menu will greet you. If the screen is blank then refer to
  1792. the Problems section in appendix A. 
  1793.  
  1794. Since you are converting a MAC file to a PCX file, choose the FILE
  1795. option. Do this by moving the highlighted bar to the FILE entry on
  1796. the menu and press Enter. You may press the F key instead. 
  1797.  
  1798. You must first READ the MAC file into the work-space so move the
  1799. highlighted area to READ and press Enter. You may also press the
  1800. R key. 
  1801.  
  1802. The file format selection screen comes up. You can jump right to
  1803. the MAC entry by pressing an M. You may also use the cursor control
  1804. keys to move over and down to the mac entry. Press Enter when MAC
  1805. is highlighted. 
  1806.  
  1807. OPTIKS looks on the disk and finds all files ending in .MAC and
  1808. displays them. If the MAC file has another extension (PIC is
  1809. common) you may not see the file. Also if the file is on another
  1810. disk you will have to change to that disk. If you see the NO
  1811. MATCHING FILES message then you can use the backspace key to move
  1812. over and enter a new file specification so that you can find the
  1813. matching files. For instance you may wish to enter C:\OPTIKS\*.PIC
  1814. instead of C:\OPTIKS\*.MAC. You can change the disk and
  1815. subdirectory here also. 
  1816.  
  1817. If there are some matching files, but they have the wrong extension
  1818. or you are on the wrong disk or in the wrong subdirectory you can
  1819. press the F10 key to get up to the file specification line. Type
  1820. in the correct disk, directory and files specification and press
  1821. enter. Once you get the correct file on the screen, move the
  1822. highlighted bar to the file that you want to read and press enter.
  1823. The hourglass appears on the screen and a second or so later the
  1824. file that you selected will appear on the screen. If you see
  1825. scrambled garbage, the odds are that the file is not an Apple
  1826. Macpaint file. 
  1827.  
  1828.  
  1829.  
  1830. D. Using Color 
  1831.  
  1832. With release 2.08 I have added the ability to show 16 color
  1833. graphics in EGA and VGA modes. The file types supported are ZSOFT
  1834. PCC and PCX, Compuserve GIF and DR's GEM Paint IMG files. I have
  1835. not tested GEM IMG files yet. The default for all systems is single
  1836. plane 2 colors. To change the default you must go to the
  1837. ENVIRONMENT menu down to SCREEN and select PLANES. The planes can
  1838. be either 1 or 4. 
  1839.  
  1840. To use color you must select 4 before you read the file or the
  1841. palette will not be set. If you try to read a normal black and
  1842. white file the planes will be reset to 1. Planes will not work
  1843. unless you are in a valid EGA or VGA mode. Color and Black and
  1844. White graphics can not be mixed. Color images can be saved and
  1845. manipulated a little, but many functions will not work with color.
  1846. No drawing and few of the image manipulators work correctly. Typing
  1847. will be very strange. 
  1848.  
  1849. Some Color images will set the palette so that the menu is nearly
  1850. invisible. The finger moves destructively on the screen and this
  1851. is a real bug which is being addressed Old EGA cards with less than
  1852. 256k on them will show odd patterns on the screen. Owners of such
  1853. cards should order an upgrade to get full use of all of the new
  1854. graphics coming out. 
  1855.  
  1856.  
  1857.  
  1858. E. Using HP Laserjet fonts. 
  1859.  
  1860. 2.08 also saw the ability to read laserjet fonts. There is not
  1861. enough memory to run OPTIKS and keep a font resident so LJ fonts
  1862. are treated as files. /FR will read files and fonts, but ERASES the
  1863. work space first. Use /FM (merge) to type on an existing graphic.
  1864. Fonts are XOR'd to the image so that they overlay the data in a
  1865. non-destructive manner. The image will show through the letters.
  1866. This may not be acceptable for some typing. Clear a space for the
  1867. letters using /IFD or /IFE. Since the fonts are loaded as files,
  1868. if a letter is not in the file buffer, the file will be re-read
  1869. from the beginning to find the file. This is very slow in large
  1870. fonts. Fonts up to about 16 point will fit entirely in the file
  1871. buffer and they will go much faster. Since most fonts are variable
  1872. spaced, the backspace key will backspace the width of the last
  1873. letter typed. To erase a letter you re-type it. Accurate typing
  1874. will save you hours of repositioning. 
  1875.  
  1876.  
  1877.  
  1878. F. Supported File Formats. 
  1879.  
  1880.    File types are: R=Raster, V=Vector, L=Language, B=LiBrary 
  1881.  
  1882.     File       Optiks  File  Description/ 
  1883.   Extension    Support Type  Software Source 
  1884.   =========    ======= ====  ================== 
  1885.     .001       Yes     R     Complete FAX page file 
  1886.     .ART       Yes     R     PFS First Publisher Clip Art 
  1887.     .ART       No      ?     Ashton-Tate Byline Clipart 
  1888.     .BAS       Yes     R     Basic Bload/Bsave (also basic programs) 
  1889.     .BSG       Yes     R     FONTASY (same as .RAW) 
  1890.     .CA        Read    RB    NewsRoom Pro 
  1891.     .CGM       No      V     Computer Graphics Metafile 
  1892.     .CUT       Yes     R     Dr. Halo, Cut files 
  1893.     .DAT       Read    RB    PrintShop 
  1894.     .DCX       Read    RB    Panasonic Fax PCX libraries. 
  1895.     .DD        No      R     CBM Doodle 
  1896.     .DHP       No      ?     Dr. Halo 
  1897.     .DRW       No      V     Freelance 
  1898.     .DRW       No      V     MicroGrafx 
  1899.     .DRW       No      V     NBI Legend 
  1900.     .DXF       No      V     AutoCad 
  1901.     .EPS       Some    VRL   Encapsulated Post Script 
  1902.     .EV        No      ?     NCN Execuvision 
  1903.     .FG        No      ?     Slidewrite Plus 
  1904.     .GAL       No      ?     HP Gallery on Exhibit, Graphics Gallery 
  1905.     .GEM       No      V     GEM Draw 
  1906.     .GMF       No      V     Computer Graphics Metafile - Various Vendors 
  1907.     .GIF       Some    R     Compuserve Graphics Interchange format
  1908.     .GX1       No      R     PC PaintBrush 
  1909.     .HPC(L)    Some    RV    Hewlett Packard's LaserJet Graphics
  1910.     .HPG(L)    No      V     Hewlett Packard Graphics Language 
  1911.     .IFF       Yes     R     Amiga Interchange Format File (graphics) 
  1912.     .IMG       Yes     R     DataCopy Wips 
  1913.     .IMG       Yes     R     GEM Paint 
  1914.     .IMG       Yes     R     IBM Image support Facility 
  1915.     .IMG       No      ?     Boeing Graph 
  1916.  
  1917.     File       Optiks  File  Description/ 
  1918.   Extension    Support Type  Software Source 
  1919.   =========    ======= ====  ================== 
  1920.     .MAC       Yes     R     Apple Macintosh Macpaint 
  1921.     .MAK       Yes     R     Apple Macintosh Macpaint, No Header
  1922.     .MSP       Yes     R     Microsoft Windows Paint 
  1923.     .P         No      ?     Ashton Tate Draw Applause 
  1924.     .PCR       Yes     R     OPTIKS/PCRGB 
  1925.     .PCX .PCC  Yes     R     Zsoft PC Paintbrush 
  1926.     .PDA       Yes     R     Palantir Scanner Graphics Files 
  1927.     .PGA       No      R     IBM Professional Graphics Adaptor image file 
  1928.     .PI1 .PI2  Yes     R     Atari Degas uncompressed images 
  1929.     .PIC       Some    V     Lotus 
  1930.     .PIC       v1.5    R     Mouse systems PC Paint 
  1931.     .PIG       Yes     R     Ricoh Pixel Image Generator file 
  1932.     .PRN       Some    VLR   Post Script, Any print image file 
  1933.     .RAS       Yes     R     Show file Ras format 
  1934.     .RAW       Yes     R     Basic Array format (OPTIKS reference only) 
  1935.     .RLE       Yes     R     Compuserve, Teletext Run Length Encoded 
  1936.     .SLD       Some    V     AutoCad Slide 
  1937.     .SFL       Yes     R     Soft Font Single Letter 
  1938.     .SFP       Yes     R     HP Soft Font 
  1939.     .SHP       Read    RB    Printmaster, Newsmaster 
  1940.     .TIF       Yes     R     Aldus/Microsoft Tag Image Format Files (TIFF) 
  1941.     .WPG       No      RV    Word Perfect Graphics 5.0 
  1942.  
  1943.  
  1944.  
  1945. OPTIKS can either read or write the files Listed as YES, Optiks
  1946. makes a good attempt at reading the files marked as SOME. Some
  1947. files marked YES can only be written or read. Library type files
  1948. and Vector graphics files are not supported by OPTIKS and will
  1949. probably never be supported. The exceptions are Lotus PIC, AutoCad
  1950. SLD and a very few EPS files. Combination of Raster and Vector May
  1951. be supported but for write only and then only Raster. 
  1952.  
  1953.  
  1954.  
  1955. G. CANON SCANNER - Technical information 
  1956.  
  1957. This information is extracted from the CANON IMAGE SCANNER IX-12
  1958.  
  1959. IXHND2 SOFTWARE SPECIFICATIONS from CANON. This guide is for using
  1960. the software with the OPTIKS program for scanning by OPTIKS. Other
  1961. programs will include additional information where needed.  The
  1962. IXHND2.COM program should be executed before attempting to use the
  1963. IX-12 Scanner. The command can be included in the autoexec.bat if
  1964. the scanner is to be used regularly. 
  1965.  
  1966. The command is of the form: 
  1967.  
  1968.     IXHND2 /xy zz 
  1969.  
  1970. Where xy is used to tell the program how the interface board
  1971. switches are set and zz is used to change the interrupt.
  1972.  
  1973.    DO NOT USE THE ZZ PARAMETER WITH OPTIKS. 
  1974.  
  1975.    VALUES OF X. 
  1976.  
  1977.     X Value   I/O Address    JP1   JP2    SW5   SW6 
  1978.       0       308 to 30F    Left  Right   OFF   OFF 
  1979.       1       318 to 31F    Right Right   OFF   ON 
  1980.       2       1A8 to 1AF    Right Left    ON    OFF 
  1981.  
  1982.   The default setting for x is 0. 
  1983.  
  1984. The y value tells the program where the buffer is located in
  1985. memory. Unfortunately the default is C000-C0FF which is the
  1986. location of the EGA Bios. You will probably have to change this
  1987. value and set the jumpers on the board if you have an EGA or VGA.
  1988. Some VGA boards go right up to C7FF. XT hard disk controllers use
  1989. C800 and some of them go up to CC00. I have not listed E000
  1990. settings because that is usually where the EMS buffers are located.
  1991.  
  1992.  
  1993.  
  1994.     VALUES OF Y 
  1995.  
  1996.     X Value   MEM Address    JP3   JP4    SW1   SW2   SW3   SW4 
  1997.       0        C000         RIGHT  RIGHT  ON    ON    ON    ON 
  1998.       1        C400         RIGHT  LEFT   OFF   ON    ON    ON 
  1999.       8        C800             N/A       ON    OFF   ON    ON 
  2000.       9        CC00             N/A       OFF   OFF   ON    ON 
  2001.       2        D000         LEFT   RIGHT  ON    ON    OFF   ON 
  2002.       3        D400         LEFT   LEFT   OFF   ON    OFF   ON 
  2003.       A        D800             N/A       ON    OFF   OFF   ON 
  2004.       B        DC00             N/A       OFF   OFF   OFF   ON 
  2005.  
  2006.  
  2007. A typical command line to install the handler if you have a VGA 
  2008. and an XT controller is: 
  2009.  
  2010.        IXHND2 /03 
  2011.  
  2012. with the jumpers set to: 
  2013.  
  2014.          Left Right Left left 
  2015.  
  2016. and the switches set to: 
  2017.  
  2018.          OFF ON OFF ON OFF OFF 
  2019.  
  2020. From reading the documentation this setting will work in most
  2021. systems. 
  2022.  
  2023. The default is /00 (will not work with EGA or VGA). 
  2024.  
  2025. Default jumpers are: 
  2026.  
  2027.          Left Right Right Right 
  2028.  
  2029. Default Switches are: 
  2030.  
  2031.          ON ON ON ON OFF OFF 
  2032.  
  2033.  
  2034.